update oss docs

Author: troZee

.github/ISSUE_TEMPLATE/config.yml

@@ -1,8 +1,5 @@
 blank_issues_enabled: false
 contact_links:
-  - name: Feature Request 💡
-    url: https://oss.callstack.com/discussions/new?category=ideas
-    about: If you have a feature request, please create a new discussion on GitHub.
   - name: Discussions on GitHub 💬
-    url: https://oss.callstack.com/discussions
+    url: https://github.com/callstack/react-native-local-notifications/discussions
     about: If this library works as promised but you need help, please ask questions there.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,26 @@
+name: Feature request
+description: Suggest an improvement to the library.
+labels: [enhancement]
+body:
+  - type: markdown
+    attributes:
+      value: Thanks for helping improve the project. Please describe the use case before proposing an API.
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What problem or limitation are you trying to solve?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: Describe the behavior or API you would like to see.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Describe any workarounds or alternative designs you considered.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,14 @@
+## Summary
+
+Describe what changed and why.
+
+## Testing
+
+List the checks you ran and the platforms you tested.
+
+## Checklist
+
+- [ ] I ran `yarn lint` and `yarn typecheck`.
+- [ ] I added or updated documentation where needed.
+- [ ] I tested native changes on each affected platform.
+- [ ] This pull request is focused on one change.

.github/dependabot.yml

@@ -0,0 +1,17 @@
+version: 2
+updates:
+  - package-ecosystem: npm
+    directory: /
+    schedule:
+      interval: weekly
+    groups:
+      development-dependencies:
+        dependency-type: development
+  - package-ecosystem: bundler
+    directory: /example
+    schedule:
+      interval: weekly
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly

.ruby-version

@@ -0,0 +1 @@
+3.4.4

CODE_OF_CONDUCT.md

@@ -60,8 +60,8 @@ representative at an online or offline event.
 ## Enforcement
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported to the community leaders responsible for enforcement at
-[INSERT CONTACT METHOD].
+reported privately to the community leaders responsible for enforcement at
+[hello@callstack.com](mailto:hello@callstack.com).
 All complaints will be reviewed and investigated promptly and fairly.
 
 All community leaders are obligated to respect the privacy and security of the

CONTRIBUTING.md

@@ -85,6 +85,11 @@ To publish new versions, run the following:
 yarn release
 ```
 
+Publishing requires maintainer access to the `@callstack` npm organization and
+the GitHub repository. The release command selects the version, creates a
+`v<version>` tag, publishes to npm, and creates a GitHub release. Before
+releasing, run `yarn lint`, `yarn typecheck`, and `yarn prepare`, then inspect
+the package with `yarn npm publish --dry-run`.
 
 ### Scripts
 

LocalNotifications.podspec

@@ -11,7 +11,7 @@ Pod::Spec.new do |s|
   s.authors      = package["author"]
 
   s.platforms    = { :ios => min_ios_version_supported }
-  s.source       = { :git => "https://oss.callstack.com.git", :tag => "#{s.version}" }
+  s.source       = { :git => "https://github.com/callstack/react-native-local-notifications.git", :tag => "v#{s.version}" }
 
   s.source_files = "ios/**/*.{h,m,mm,swift,cpp}"
   s.public_header_files = "ios/InitialNotificationActionStore.h"

README.md

@@ -1,8 +1,10 @@
-# react-native-local-notifications
+# @callstack/react-native-local-notifications
 
 Recover the local-notification action that launched your React Native app from a terminated state.
 
-`react-native-local-notifications` bridges the cold-start notification response to JavaScript on iOS and Android. It gives your navigation or analytics code one consistent, typed action without taking ownership of notification scheduling or live notification events.
+`@callstack/react-native-local-notifications` bridges the cold-start notification response to JavaScript on iOS and Android. It gives your navigation or analytics code one consistent, typed action without taking ownership of notification scheduling or live notification events.
+
+Third-party services such as Braze or Firebase often already handle actions from remote notifications. This library is intended for applications where local and remote notifications use different mechanisms: keep using your existing provider for remote notifications, and use this package to recover the initial action from a local notification when it launches the app.
 
 ## Why use it?
 
@@ -15,15 +17,15 @@ Recover the local-notification action that launched your React Native app from a
 ## Installation
 
 ```sh
-yarn add react-native-local-notifications
+yarn add @callstack/react-native-local-notifications
 ```
 
 Or use your preferred package manager:
 
 ```sh
-npm install react-native-local-notifications
+npm install @callstack/react-native-local-notifications
 # or
-pnpm add react-native-local-notifications
+pnpm add @callstack/react-native-local-notifications
 ```
 
 Install iOS pods after adding the package:
@@ -40,7 +42,7 @@ Read the initial action once during application startup:
 
 ```tsx
 import { useEffect } from 'react';
-import { getInitialNotificationAction } from 'react-native-local-notifications';
+import { getInitialNotificationAction } from '@callstack/react-native-local-notifications';
 
 function App() {
   useEffect(() => {
@@ -133,7 +135,8 @@ useEffect(() => {
     // Use one navigation path for cold-start and live actions.
   };
 
-  const subscription = subscribeToLiveNotificationActions(handleAction);
+  // additional subscription to notifications
+  const subscription = subscribeToRemoteNotificationActions(handleAction);
 
   getInitialNotificationAction()
     .then((action) => {
@@ -150,16 +153,14 @@ useEffect(() => {
 }, []);
 ```
 
-`subscribeToLiveNotificationActions` is a placeholder for the listener supplied by your notification solution; it is not exported by this package.
+`subscribeToRemoteNotificationActions` is a placeholder for the listener supplied by your notification solution; it is not exported by this package.
 
 ## API
 
 ### `getInitialNotificationAction()`
 
 ```ts
-function getInitialNotificationAction(): Promise<
-  InitialNotificationAction | null
->;
+function getInitialNotificationAction(): Promise<InitialNotificationAction | null>;
 ```
 
 Returns the notification action that launched the current application process, or `null` when the app was opened normally or the action has already been consumed.
@@ -176,12 +177,12 @@ type InitialNotificationAction = {
 };
 ```
 
-| Field | Description |
-| --- | --- |
-| `notificationId` | Identifier of the notification that triggered the action |
-| `categoryId` | Notification category, when supplied |
-| `channelId` | Android notification channel; always `null` on iOS |
-| `action` | Normalized tap, clear, or custom action |
+| Field              | Description                                                   |
+| ------------------ | ------------------------------------------------------------- |
+| `notificationId`   | Identifier of the notification that triggered the action      |
+| `categoryId`       | Notification category, when supplied                          |
+| `channelId`        | Android notification channel; always `null` on iOS            |
+| `action`           | Normalized tap, clear, or custom action                       |
 | `actionIdentifier` | Platform action identifier for a custom action, when supplied |
 
 The value is held in memory and atomically consumed. The first call receives it; later or concurrent calls return `null`. It is not persisted between application processes.
@@ -204,8 +205,8 @@ A Jest mock is available as a package export:
 
 ```js
 moduleNameMapper: {
-  '^react-native-local-notifications$':
-    'react-native-local-notifications/jest/mock',
+  '^@callstack/react-native-local-notifications$':
+    '@callstack/react-native-local-notifications/jest/mock',
 }
 ```
 

SECURITY.md

@@ -0,0 +1,16 @@
+# Security Policy
+
+## Supported versions
+
+Security fixes are provided for the latest published version of
+`@callstack/react-native-local-notifications`.
+
+## Reporting a vulnerability
+
+Please do not disclose security vulnerabilities in a public issue. Report them
+privately through [GitHub's private vulnerability reporting](https://github.com/callstack/react-native-local-notifications/security/advisories/new)
+or email [hello@callstack.com](mailto:hello@callstack.com).
+
+Include the affected version, platform, impact, reproduction steps, and any
+known mitigations. We will acknowledge the report as soon as practical and keep
+you informed while we investigate and prepare a fix.